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1. INTRODUZIONE 


1.1 Premessa 


Presso ERG-FISS si е” presentata la necessita’ di installare un database relazionale in un server 
Web per permettere ai client l'accesso ai dati resi ad essi disponibili. 


La scelta del database e' caduta su Mini SQL, piu' semplicemente chiamato mSQL, che e' un 
motore di database leggero, con accesso veloce ai dati e non eccessive richieste di memoria, il cui 
autore е’ David J.Hughes della Bond University in Australia. 


1.2 Caratteristiche del database adoperato 


L'interfaccia di interrogazione mediante query dell'mSQL e' un sottoinsieme dell'SQL, 
conforme alle specifiche ANSI SQL. 


mSQL e’ un database relazionale, che permette quindi relazioni tra tabelle multiple, anche se 
non supporta tutte le possibilita” relazionali (joins, views, nested queries). 


Il motore database e’ stato testato su piattaforme Sun (SunOS e Solaris), Ultrix, Linux e OSE/1. 
Pero’ puo’ andare anche sulla maggior parte di sistemi derivati dal BSD e dal SVRA, o sistemi 
POSIX. Siccome mancava ogni informazione sull'utilizzazione su IBM-RISC6000 con sistema 
operativo АТХ si e’ cercato sul Web (mailing list, vedi paragrafo 8.3) di sapere se altri lo 
adoperano su questa piattaforma ed hanno risposto Jens-Peter Haack del  NetCS 
Informationstechnik GmbH 4 Aschaffenburg in Germania (Peter NetCS.com), che ci ha 
comunicato che loro stanno usando mSQL su Power PC con i sistemi operativi AIX 3.2.5 e AIX 
4.14, e trevor@cyberspc.mb.ca, che ci informa che il databse va molto bene su ATX versione 4. 
Lo stesso autore, Hughes (bambi  Bond.edu.au), da noi consultato, ha risposto personalmente 
confermando che il software puo' girare su AIX, anche se per questo sistema operativo loro non 
l'hanno testato. 


Il pacchetto mSQL comprende: 

- il motore di database, per avviare o spegnere il database server 

- un programma di amministrazione di database, per gestire il database 

- un programma “monitor” di terminale, per inviare le query al motore di database 
- un visore di schemi, per vedere la struttura del database 


- un “dumper”, per creare da un database uno Script adatto alla riproduzione dello stesso 
database 


- un'interfaccia di programmazione API per l'accesso al database da programmi in linguaggio 


C 


MEOS e. 


Il motore di database e l'API per C sono progettati per un funzionamento in ambiente 
client/server in una rete TCP/IP. 


Il motore del database comprende un "demone", chiamato msqld, che e’ in ascolto continuo di 


eventuali connessioni su un socket TCP. Esso accetta connessioni multiple e serializza le query 
ricevute. 


1.3 Controllo di accesso 


Il controllo di accesso viene gestito dal file msql.acl presente nella directory di installazione 
del database, che normalmente e’ la /usr/local/Minerva. Su tale file vengono scritti i riferimenti per 
ogni database da controllare. 


Esempio di file acl: 


database=test (nome del database cui ci si riferisce) 

read-spagna, meneghini, -* (accesso in lettura negato a tutti, salvo quelli specificati) 
write-root (accesso in scrittura permesso solo alla root) 
host-*.arcoveggio.enea.it (qualunque host nel dominio arcoveggio.enea.it) 
access-local,remote (accesso da connessioni locali o remote) 


Se un tale file non esiste o se mancano i riferimenti ad un certo database l'accesso alla lettura 
ed alla scrittura e' globale. 





2. COMANDI SQL DISPONIBILI 


Si riportano qui i comandi (clause) SQL disponibili per l'accesso ai dati del database. I comandi 
sono stati evidenziati in caratteri maiuscoli, ma cio' non e' obbligatorio nella scrittura delle query, 
che non sono case sensitive. 


21 Clause CREATE 


Tale comando crea una tabella. 


Esempio: 
CREATE TABLE impiegati (cognome char(16), 
nome char(16) not null, 
numero int primary key, 


matricola int ) 


dove i tipi possibili sono: char( lungh) (stringa di caratteri di una determinata lunghezza), int 
(interi con segno di 4 byte) e real (valori reali in notazione decimale o scientifica). Un campo 
puo’ essere definito o no come chiave primaria (primary key)o not null. 


2.2 Clause DROP 


Tale comando cancella una tabella da un database. 
Esempio: 


DROP TABLE impiegati 


2.3 Clause INSERT 
Questo comando inserisce dei dati. 
Esempio: 


INSERT INTO impiegati {cognome, nome, matricola) 


VALUES ('Spagna', ‘Ferruccio’, 79960) 


2.4 Clause DELETE 


Tale comando cancella una riga. 
Esempio: 


DELETE FROM impiegati WHERE numero = 123 


Per la condizione WHERE vedi paragrafo seguente. 








2.5 Clause SELECT 


Questo e' il comando SQL fondamentale per fare delle ricerche mediante una selezione dei dati 
che soddisfano determinate condizioni. 


Esempio: 


SELECT [DISTINCT] cognome, nome FROM impiegati 
WHERE matricola - 79960 AND cognome LIKE ' pagna' 
ORDER BY Cognome, nome DESC 


ove: 

SELECT seleziona i campi 

FROM indica da quale tabella vengono selezionati i dati 

WHERE esprime una condizione (=, <, >, <=, >=, <>, LIKE) 

AND somma due condizioni 

LIKE e’ una condizione con certi caratteri indeterminati (vedi sotto per. e %). 


ORDER BY dice se i dati ordinati per ordine decrescente (se DESC, altrimenti crescente) 
DISTINCT sesi vogliono eliminare le righe duplicate 


I caratteri speciali sono: 
‘indica un carattere qualunque (in una condizione LIKE) 
‘%’ indica un numero qualsiasi di carattere di qualunque valore (in una condizione LIKE) 
"V. viene fatto precedere ai caratteri speciali: per es. \% equivale a % e W equivale a \ 


Il comando: 
SELECT * etc. 


si riferisce a tutti i campi delle righe. 


2.6 Clause UPDATE 


Tale comando aggiorna un campo. 


Esempio: 


UPDATE impiegati SET matricola = 79960 WHERE numero = 123 


27 SCRIPT DI QUERY SQL 


I comandi per le query SQL possono essere scritti su un file di testo (script) che potra" essere 
dato come input al motore database (vedi paragrafo 6.2). Un esempio di script e' riportato qui: 


de-------22222z22-2z2.2200222202222 
* Esempio di file script miniSQL 
ГЕНЕ НОРИИ а ичрои d n s 
drop table tabellal \p\g 
drop table tabella2 \p\g 


create table tabellal ( 
nome char (10) primary key, 
matr int, 
tel char(20), 


indir char(20) ) Mp Sg 


create table tabella2 ( 
user char(10) primary key, 


nome char(30) ) \p\g 
insert into tabellal(nome, matr, tel) values ('Spagna', 36, '3488') \p\g 
insert into tabellal(nome, matr, tel) values ('Meneghini', 35, ‘'3411') 
\p\g 
insert into tabella? (user, name) values('Spagna', 'F. Spagna') \p\qg 
insert into tabella2(user, name) values('Meneghini',  'L. Meneghini') 
\p\g 
% ------------ 
# Keyed lookup 
d ------------ 
select tel from tabellal where name = 'Spagna' \p\g 
select * from tabellal \p\g 





update tabellal set matr=46 where name-'Spagna' \p\g 


select * from tabellal \p\g 
# ама Ji n a а — EY 
# Non-key passed lookup 
Ù bannan NEA E 
select * from tabellal where tel = '3488' \p\g 


select * from баре11а1 where name like ' pag$' \р\9 


select tabella2.nome, tabellal.tel 
from tabella,tabellal 


where tabella2.user - tabellal.nome \p\g 
# cacatua ae 
# Try a sorted one 
go docs ы a 


select tabella2.name, tabellal.tel 
from tabella2,tabellal 
where tabella2.user = tabellal.nome 
order by tabella2.nome \p\g 


2.8 Presentazione dei risultati di una query 


I risultati di una query, ad esempio: 


$ msql elenco 
msql > select cognome, tel from telefoni where cognome like 'SP$' Vg 


sono presentati sullo schermo in una forma del tipo: 

















Query OK. 
3 rows matched. 


+---------------------- +---------- + 
| cognome | tel | 
+---------------------- +---------- + 
| Speranza | 3568 | 
| Spagna | 3488 | 
| Spadoni | 3514 | 
+---------------------- +---------- + 








3. IL MOTORE DI DATABASE 


Il "demone" mSQL e' un'applicazione che, una volta lanciata con il comando: 


$ msqla 


resta in attesa di connessioni su un determinato socket TCP (accesso remoto in rete) o un socket di 
dominio UNIX. Esso supporta connessioni multiple e serializza le query ricevute. 


4. AMMINISTRAZIONE DEL DATABASE 
I database mSQL sono amministrati mediante un comando della forma: 
$ msqladmin operazione 

ad esempio: 


$ msqladmin create mioDB 
mediante il quale si possono fare (soltanto il root ne е” autorizzato) alcune operazioni come creare 
nuovi database o chiudere il server. Il comando richiede necessarimente come argomento uno dei 


comandi disponibili, che sono: 


create nomeDataBase (crea un nuovo database) 


drop nomeDataBase (cancella un intero database esistente) 

shutdown (spegne il server) 

reload (dice al server di ricaricare l'informazione di controllo d'accesso) 
version (fornisce informazioni sulla versione) 


Il comando accetta il flag di linea di comando -hHost per specificare la macchina. 


5. MONITOR DI TERMINALE mSQL 


5.1 Query da linea di comando 


Il programma monitor che permette di sottoporre interattivamente da linea di comando delle 
query ad un motore database mSQL si chiama con il comando: 


$ твч1 nomeDatabase 


che richiede necessariamente come argomento il nome del database. Il programma e' stato fatto sul 
modello di quello del monitor del database Ingres. Il lancio del comando introduce nell'ambiente 
di query caratterizzato dal prompt: 


msql > 


I comandi al monitor sono costituiti da certi caratteri preceduti da un \ (backslash), ad esempio 
\h (h sta per help) da’ l'help e \q (q sta per quit) fa uscire dal programma (l'uscita si puo’ 
ottenere anche con Ctrl-D). 


Le query da inviare al motore mSQL possono essere sottoposte in vario modo: in primo luogo 
da linea di comando direttamente, come ad esempio: 


msql > update miaTabella set telefono = 3488 where nome = ‘Spagna’. \g 


dove il comando Vg (g sta per Go), scritto alla fine, produce l’effetto di inviare la query che lo 
precede. Cio’ che viene scritto in linea di comando viene posto, dopo il tasto invio, in un buffer di 
query. Se la query ha un carattere \g alla fine, essa viene inviata subito al monitor con il tasto 
invio, altrimenti resta sul buffer e puo' essere inviata successivamente con un comando \g 
separato in linea di comando: 


msql > \g 


Una o piu’ query possono essere inviate al monitor dopo averle redatte con un editore di testo: 
il comando: 


msql > \e 


ove il comando \e (e sta per edit) permette di editare la query precedente o una nuova se non ce 
n'e’ alcuna nel buffer, aprendo automaticamente l’ambiente vi, o altro editore se se ne e’ scelto 


uno diverso, uscendo dal quale la query е’ inviata al buffer e subito eseguita se essa termina con il 
comando Vg. 


La memorizzazione su buffer dell'ultima query permette il rinvio della stessa query successive 
volte con diversi comandi Mg oppure l'eventuale riedizione di essa con Ne. 


5.2 Query da file script 


Un altro modo di sottoporre delle query е' quello di scrivere le query su un file script, file 
portante l'estensione .msgl, e poi sottoporre il file al programma con il comando: 


$ msql nomeDB«fileScript.msql 


Il contenuto del buffer di query puo' essere visualizzato con il comandi Vp (p sta per print). 
Il comando msq1 accetta due tipi di flag sulla linea di comando: 


-hHost per una connessione al server mSQL su host 
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-q 


per uscire (quit) dopo l'esecuzione della query. 





6. VISORE DI SCHEMA 


Il comando relshow permette di visualizzare la struttura di un database. Se il comando e' 
usato da solo, senza argomenti: 


$ relshow 


esso mostrera' il nome di tutti i database disponibili cosi": 


+----------------- + 
| Databases | 
+----------------- + 
| Databasel | 
+-------------—---- + 


Se invece relshow е” usato con argomento uguale al nome di un database esistente: 


5 relshow nomeDB 


sono visualizzate le tabelle di quel database nella forma: 


*----------------- * 
| Table | 
+----------------- + 
| Tabellal | 
+----------------- + 


Se infine relshow viene usato con il nome di un database e quello di una tabella: 


$ relshow nomeDB nomeTabella 


зага” visualizzata la struttura della tabella con i nomi dei campi, il loro tipo e le loro dimensioni 
con uno schema della forma seguente: 


, 


+----------------- +--------- +--------- ж---------- +--------- + 
| Field | Type | Length | Not Null | Key | 
*-----------.--2--22- +--------- +--------- +---------- +--------- + 
| поте | char | 16 | N | N | 
ж----------------- +--------- +--------- +---------- +--------- + 
| matricola | int | 4 | N | N | 
+----------------- +--------- +--------- +---------- +--------- + 


Il comando relshow accetta il flag di linea di comando -h Host con cui si specifica una 
macchina remota come server del database. 


7. DATABASE DUMPER 


Il programma chiamato con: 


$ msqldump nomeDB [nomeTabella] 


scarica il contenuto e la struttura di una tabella o di un intero database in un file in formato testo 
con i comandi opportuni adatto per essere letto dal monitor come file script per riprodurre il 
database o la tabella, secondo quanto spiegato al paragrafo 6.2. 





8. LIBRERIA (API) DI PROGRAMMAZIONE IN C 


8.1 Uso dell'API in C 


La libreria di API per il C permette ad un programma scritto in linguaggio C di comunicare con 
il motore di database. Un programma di questo tipo deve includere lo header msql.h ed essere 
linkato con la libreria libmsql.a (argomento -lmsql alla compilazione su riga di comando). La 
libreria rende disponibili le funzioni presentate nei paragrafi seguenti. Per default msql.h e’ 
installato nella directory /usr/local/Minerva/include e msgl.a in /usr/local/Minerva/lib. 


8.2 Funzione mqsiConnect() 
int msqlConnect (char *host) 


Questa funzione stabilisce una connessione con un motore mSql. Richiede come argomento 
l’indirizzo IP dell’host che gestisce il server mSQL., Se tale argomento e’ posto uguale a NULL la 
connessione е” fatta ad un server che funziona su host locale usando il socket di dominio UNIX 
(/dev/msqld ?). 


Tale funzione restituisce un intero che rappresenta il socket descriptor della connessione, che 
puo” essere usato come handle per le successive chiamate di funzioni dell АРІ che richiedono 
come argomento il socket. Se c'e' un errore oppure se non si e’ potuta stabilire la connessione il 
valore restituito e' -1. 


Sono possibili diverse connessioni contemporanee a diversi server di database con diverse 
chiamate di questa funzione. 


8.3 Funzione msqliSelectDB() 
int msqliSelectDB(int Socket, char *nomeDB) 


Questa funzione seleziona il database a cui si vuole accedere per effettuarvi delle query, e in 
essa il primo argomento e’ il socket descriptor restituito dalla funzione mqsIConnect() ed il 
secondo e’ il nome del database. E’ possibile chiamare diverse volte questa funzione anche con 
parametri diversi: ciascuna volta il server, passando da un database all'altro, usera’ per gli accessi 
Successivi il database specificato. 


8.4 Funzione mgsiQuery() 
int msqlQuery(int socket, char *query) 


Questa funzione, che ha come primo argomento il socket descriptor restituito dalla funzione 
maslConnect (), invia una Query come stringa di testo al motore del database sulla connessione 
associata con il socket specificato. 


Se la query ottiene dei risultati dal motore di database (come in seguito ad una query di tipo 
SELECT), i dati sono posti in un buffer e possono quindi essere salvati con la funzione 
msqlStoreResult(). Se non vengono salvati, i dati saranno sovrascritti dalle query seguenti. 
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8.5 Funzione msglStoreResult() 
m result *msqlStoreResult() 


Questa funzione, che restituisce un puntatore ad una struttura di tipo m result, salva i dati 
generati da una query di tipo SELECT. E' un'operazione da fare prima di chiamare una nuova 
query per non perdere i dati residenti sul buffer, che altrimenti verrebbero soprascritti. La funzione 
restituisce un puntatore ad una struttura di tipo m result e sara’ l'oggetto cosi’ creato ad essere 
utilizzato come parametro nelle funzioni msql che seguono in questa lista, che devono quindi 
essere sempre precedute dal salvataggio dei dati con la funzione mqslStoreResult (). Di 
questi result handle ce ne possono essere diversi contemporaneamente in un programma. 


8.6 Funzione msqiFreeResult() 
void msqlFreeResult(m result *result) 


Questa funzione puo’ essere chiamata quando i dati generati da una query e salvati in un result 
handle non sono piu’ necessari, per liberarli. 


8.7 Funzione msqlFetchHow() 
m row msqlFetchRow(m result *result) 


La funzione, che permette l'accesso alle righe del database risultanti da un SELECT, restituisce 
una struttura di tipo m row che contiene un puntatore a carattere per ognuno dei campi selezionati 
della riga. Un valore NULL e’ restituito quando e’ stata raggiunta la fine dei dati. 


8.8 Funzione msqiDataSeek() 

void msqlDataSeek(m result *result, int posizione) 

La struttura m. result possiede una variabile “cursore” che da’ il numero della prossima riga. 
La funzione msqlDataSeek() permette di cambiare la posizione del cursore, dando il valore 


come parametro (posizione), essendo 0 corrispondente alla prima riga. Se il parametro posizione 
oltrepassa la dimensione della tabella la funzione restituisce NULL. 


8.9 Funzione msqiNumRows() 
int msqliNumRows (m result *result) 
Questa funzione restituisce il numero di righe risultanti da una query. L'argomento da passare 


е" l'handle di tipo m result restituito da msglStoreResult(). La funzione restituisce il 
numero di righe risultante dalla query (che puo' eventualmnte essere anche 0). 


8.10 Funzione msqlFetchField() 


m field msqlFetchField(m result *result) 
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Questa funzione fornisce le caratteristiche di ciascuno dei campi (uno alla volta, NULL quando 
i campi sono terminati) della tabella mediante un puntatore ad una struttura di tipo m field * 
cosi' definita: 


typedef struct ( 
Char *nomeCampo, 


*nomeTabella; 
int tipoCampo, 
lunghCampo, 
flagsAttributo; 
) m field; 


8.11 Funzione msglFieldSeek() 


void msqlFieldSeek(m result *result, int pos) 


Una struttura di tipo m. result contiene come membro la posizione del cursore per i campi. 
La funzione msqlFielaseek() puo’ fissare la posizione di tale cursore. 


8.12 Funzione msqlNumFields() 
int *msqlNumPFields(m result *result) 


Questa funzione fornisce il numero di campi restituiti da una query. Questo valore rappresenta 


il numero di elementi del vettore di dati ritornato dalla funzione msqlFetchRow(). E' buona 
norma chiamare tale funzione per poi evitare di oltrepassare il limite del vettore di dati. 


8.13 Funzione msqglListDBs() 
m result *msqlListDBs(int Socket) 


Tale funzione da' una lista dei database conosciuti dal motore mSQL restituendo un puntatore a 
strutture di tipom result. 


8.14 Funzione msglinitDB() 
msqlInitDB() 


Seleziona un database. 


8.15 Funzione msglListTables() 
m result *msqiListTables(int Socket) 


Questa funzione fornisce una lista delle tabelle definite in un database selezionato con una 
funzione msalInitDB (), restituendo un result handle. 
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3.16 Funzione msqlListFields() 
*nomeTabelia) 


int socket. char 


m result *msglbistFields ( 


Tale funzione fornisce i campi in una particolare tabella. 


8.17 Funzione msqlClose() 


qiClose(int socket) 
o della funzione e’ il 


a della connessione. 


int ms 
sione con il motore mSQL. L’ argoment 


connes 
) al momento dell apertur: 


Funzione che chiude la 
dalla msqlConnect ( 


socket descriptor restituito 
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. LIBRERIA (API) DI PROGRAMMAZIONE IN JAVA 


11 Uso dell’API in Java 


МзајЈауа e’ una libreria di classi Java che permette ad applicazioni Java o ad applet di accedere 
manipolare database mSQL. Si trova in: 


http://mama.minmet.uq.oz.au/msgljava 


2 Classe Msql 


La classe Msq1 possiede i metodi seguenti. 


).2.1 Metodo Msql() 
Msql() 


Metodo constructor per l’istanziazione di un oggetto Msql. 


3.2.2 Metodo Connect() 


Connect() 


Questo metodo puo' avere uno, due o tre argomenti (overloaded).L' argomento del metodo e' la 
stringa rappresentante il nome dell'host che gestisce il server mSQL (si assume che la porta di 
destinazione sia la radice, cioe’ la 1112). Il metodo apre un socket sulla destinazione data. I] server 
invia al client come stringa la versione del server ed il client invia quindi al server il nome 
dell’utilizzatore, perche’ il server ne possa fare i controlli per eventuali restrizioni mediante l’ ACL 
(Access Control List, vedi paragrafo 1.3). Il server invia infine al client una stringa di stato 
indicante se l’utilizzatore ha avuto accesso. Se non sono sorte eccezioni a questo punto viene 
stabilita la connessione. 


9.2.3 Metodo SelectDB() 
SelectDB() 


Vedi funzione analoga nell' API in C. 


9.2.4 Metodo ListFields() 
MsqlFieldDesc ListFields() 


Vedi funzione analoga nell’ API in C. 





„2.5 Metodo Query() 


MsqlResult Query() 


Tale metodo viene usato per inviare le query al server e restituisce un oggetto di classe 
IsqlResult (vedi paragrafo 10.3), che rappresenta il risultato della query (solo quelle di tipo 
SELECT producono dei dati). 


2.3 Classe MsqiResult 


3.1 Membri della classe 


La classe MsqlResult serve a contenere e trattare i dati risultanti da query di tipo SELECT. 
Tali query producono una nuova tabella che e’ contenuta nell’oggetto restituito dal metodo, ma 
just'oggetto comprende anche una seconda tabella contenente informazioni sulle colonne presenti 
vella prima tabella. La classe MsqlResult possiede i metodi seguenti. 


3.3.2 Metodo FetchRow() 
String[] FetchRow() 


Vedi funzione analoga nell' API in C. 


3.3.3 Metodo Close() 
Close() 


Metodo che chiude la connessione al server mSQL. 


9.3.4 Istruzioni fondamentali 


Ogni programma Java per mSQL possiede in generale le seguenti istruzioni fondamentali: 


Msql M - new Msql(); // istanzia l'oggetto 
M.Connect("mioSito"); // stabilisce la connessione 
M.SelectDBR("mioDB"); // seleziona il database 
MsqlResult R = M.Query("select... from miaTab..."); // esegue la query 
M.Close(); // chiude la connessione 


9.3.5 Package msql 


Il package msql e’ disponibile presso: 


htip://mama.minmet.uq.oz.au/msgljava/packages.html 





Esempio di programma in Java 


1 Esempi dell'autore di MsqlJava 


q.oc.au/msgljava/msglexamples.html sono riportati i tre 


ella pagina Web htt://mama.minmet.u 
messa a disposizione del 


ipi seguenti di Darryl Collins (darryl € minmet.uq.oz.au), con la 
ze sorgente: 


{sqlDemo.java 
AsqlJavaStats.java 


AsqlViewer.java 


.2 Esempio nostro 


3i riporta qui un esempio di un semplice programma scritto da noi in Java per l’accesso ad un 


ibase mSQL. 


‚ ACCESSO DA LINGUAGGIO DI SCRIPT PERL 
Per l'accesso all’ mSQL mediante Perl e’ disponibile la Perl 5 Interface in: 
fip://Bond.edu.au/pub/Minerva/msql/Contrib/DBPerl/ 


nei file: 
DBD-msql-0.59.tar.Z е 
DBI-0.58.tar.Z 


. PROGRAMMA CON INTERFACCIA HTML A mSQL 


Un programma di Sol Katz (skatz@blm.gov), scritto per creare un'interfaccia html a mSQL e' 


;iponibile sul Web sotto forma del file: 


ft:/(ftp.blm. gov/pub/gis/msglc2.zip 
rmazioni relative al database ed alle tabelle da usare sono 


mprendente i file cgi in C. Tutte le info 
deve essere modificato quando si usano altri database 


ste nell'html, e pertanto il programma non 
abelle. 


2. IMPORTAZIONE DI DATI DA UN FILE DI TESTO 


Il programma msgl-import (autore Pascal Forget, pascal@wsc.com), scritto in linguaggio C, 
smette di importare in una tabella mSQL dei dati scritti su un file di testo e separati da un 
limitatore qualsiasi in una tabella di un database. Il programma non crea la tabella, che deve 
iere stata creata prima, e agisce inviando delle query di tipo INSERT al server mSQL. 
isponibile come: 

fip://Bond.edu.au/pub/Minerva/msql/Contrib/msql-import-0.0.9.tar.gz 











I3. ESEMPIO DI IMPORTAZIONE DI UN DATABASE 


L'esempio che si riporta in questo paragrafo consiste nell'importazione in un database mSQL di 
ati da un database esistente in formato dBase (.dbf) attualmente usato dall’amministrazione del 
%entro per i numeri telefonici dei dipendenti. 


La prima operazione e’ quella di creazione del database, che chiamiamo "elenco", ed e' 
ffettuata dal root sulla macchina Risc365, su cui e’ installato l'mSQL, mediante il comando: 


$ msqladmin create elenco 


Viene quindi editato (da parte del root) il file msqlacl (vedi paragrafo 1.3) situato in 
isr/local/Minerva per aggiungervi le righe relative al controllo di accesso al nuovo database: 


database = elenco 

read = * 

write = spagna, root, -* 
host = *.arco.e.it 
access - local,remote 





Siccome poi si vuole importare la tabella del database originario che ha la struttura seguente: 


cognome 20 T 


nome 20T 
matr 5T 
tel N 
segr N 
fax N 
sede 8T 
sottosede 2 T 
unita 20 T 
pal 2T 
stanza 4T 
titolo ST 


sottopone la query seguente per creare la struttura della nuova tabella mSQL: 


Strutture della tabella 'telefoni' 


EATE TABLE telefoni ( 
cognome CHAR(20), 
nome CHAR(20) 
matr CHAR(5), 
tel INT, 
segr INT, 
fax INT, 
sede CHAR(8), 
Sottosede CHAR(2), 
unita CHAR(20) 
pal CHAR(2), 
stanza CHAR(4), 
titolo CHAR(5) 

Sg 





А questo punto, essendo cosi' creati il database e la tabella con la sua struttura, si puo' lavorare 
l'importazione, per la quale ci si serve del programma DBMS Microsoft Access (ma si sarebbe 
uto utilizzare qualunque altro sistema analogo, per esempio l'importazione con Microsoft Excel 
mette un trattamento di testo piu' agevole). Il file dBase, chiamato tel4.dbf, viene importato in 
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cess come database. Siccome si vuole quindi preparare uno script di query per introdurre i 
‘ord di tab4.dbf con una serie di righe del tipo: 


SERT INTO telefoni VALUES ('ABBATTISTA', 'MARIATERESA', '1048', 3403, 
0, 0, 'BOLOGNA', 'А', 'ERG-BOL-SEPER', Е"; 109777, 'Sig.a') 

ISERT INTO telefoni VALUES ('ADORNI', 'GIOVANNA', '1308', 3758, 
0, 0, 'BOLOGNA', 'A', 'HPCN', 'c', ]301!, ‘D.ssa') 


$ 


aggiungono in ambiente Access (nel quale tali operazioni sono agevoli) alla tabella altri campi 
e rappresentano l'inizio del rigo (un primo campo e' costituito dalla stringa da “INSERT... fino 
..VALUES (*" ), i separatori tra campo e campo (tipo [5] [5] o D) ela fine del rigo (ultimo 
mpo costituito da / ‘) W 7). Quest'operazione va fatta precedere da una sostituzione di tutti gli 
vostrofi, gia” presenti nella tabella originaria come accenti, con caratteri V. 


Si puo’ allora esportare il database come testo su un file ASCII cui si da’ il nome tel4.msgl, che 
gia’ adatto per essere sottoposto come script al motore msql mediante il comando: 


$ msql elenco<tel4.msql 


La tabella е” cosi’ riempita con i dati voluti e l'operazione e' conclusa. 


4. DISPONIBILITA” DEL SOFTWARE 


4.1 Disponibilita’ dell'mSQL 
Una Mini SQL Home Page e’ presentata sul sito Web Hughes Technologies, all URL: 
http://Hughes.com.aw/product/msql/ 


1 cui viene fatta una prima presentazione di mSQL e da cui si possono richiamare i seguenti 
ocumenti: 


- Frequently Asked Questions (FAQ) (faq.htm) (gestito da Peter.SamuelQ uniq.com.au) 


- Conference Paper (paper.htm) 
- On-Line Manual (manual.htm) 
- Release History (history.htm) 


: collegarsi al sito ftp da cui fare il downloading del software e cioe": 
ftp///Bond.edu.awpub/Minerva/msql 


lella Bond University, Gold Coast, Queensland, Australia, sul quale e’ disponibile la versione di 
nSQL costituita dal file compresso msql-1_0_15_tar.gz (191 KB), che e' la versione del 3 luglio 
6, da noi utilizzata per le prove, e i documenti faq.html e faq.txt. 


14.2 Disponibilita’ dell'UsqlJava 


Nella directory Contrib/ del sito ftp suddetto sono disponibili per il downloading diverse 
interfacce all'mSQL da Java, Perl, Tcl, REXX e Python. Noi abbiamo scaricato i file relativi 
а interfaccia Java (autore Darryl Collins): 


- MsqlJava-1 1 l!.zip (22 KB) 
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- dbview.c (16КВ) 
- dbview.c.Ism (563 B) 
- dbview.README (1 KB) 
= msqI-JDBC 0 9 3 tar.gz (32 KB) driver JDBC per mSQL di Darryl Collins. 
Presso il sito: 
http://mama.minmet.ug.oz.au/msgljava/ 
(riportato anche da Attp://www.gamelan.com) si possono trovare i documenti: 
- Tutorial 
- FAQ 
- Inside MsqlJava 
- Documentation 
- Download MsglJava (stesso sito gia’ riportato sopra) 


- Examples: tre esempi di programmi Java per accesso ad alcuni database presenti sul sito. 


Degli esempi di uso di Java per l’mSQL sono riportati al URL: 
http://adams.patriot.net/-anil/java/javaSQL/ 


4.3 Installazione dell'mSQL sull’IBM-RISC6000 
Il file msql-1_0_15_tar.gz, esploso con il comando: 
$ gunzip msql-1 0 15 tar.gz 

nera un file msql-1_0_15. tar che viene trattato con: 
$ tar -tvf msql-1 0 15 tar 


si vengono così’ a creare in totale 2480 KB: 


files: Makefile 
README (con le istruzioni per l'installazione) 
directory: bin 
doc (con vari documenti di testo) 
include (con diversi file #include) 
lib (con diversi file di libreria) 
Scripts (con diversi file script, tra cui run, daemon per lanciare il server) 
src (con diversi file sorgente: .C e .H in sei sottodirectory 


e vari script di casi di prova) 


Per fare il build dell' mSQL il comando е”: 
$ make target 


he crea una directory target dove andranno i file object per il sistema ospitante: 
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«sha 











ОР)Лагре!5/АТХ-4.1-г56000 | 


oi, da questa directory si esegue: 

$ setup 

indi 
$ make o make istall? 


Mine: 





| $ make all 





La directory di default dell’installazione sara! /usr/local/Minerva/. 


| Una volta installato mSQL si puo’ provare lo script di prova sample.msql. 
| | 


14.4 Mailing list 

| 

| Una mailing list disponibile per gli utenti di mSQL, cui ci siamo inscritti, e’ all'indirizzo: 
| gl-list-request Bunyip.com per l'iscrizione mediante “subscribe” 


bsgl-list@ Bunyip. com per l'invio di messaggi 
| 
$ 
| 
i 
i 


22 


. INTRODUZIONE 


1 Premessa 
2 Caratteristiche del database adoperato 
3 Controllo di accesso 


. COMANDI SQL DISPONIBILI 
1 Clause CREATE 

2 Clause DROP 

3 Clause INSERT 

4 Clause DELETE 

[5 Clause SELECT 

26 Clause UPDATE 

[7 SCRIPT DI QUERY SQL 


8 Presentazione dei risultati di una query 


8. IL MOTORE DI DATABASE 





W. AMMINISTRAZIONE DEL DATABASE 


5. MONITOR DI TERMINALE MSQL 
51 Query da linea di comando 

52 Query da file script 

6. VISORE DI SCHEMA 

7. DATABASE DUMPER 

8. LIBRERIA (API) DI PROGRAMMAZIONE IN C 
Ва Uso dell’API in С 

8.2 Funzione mqslConnect() 

8,3 Funzione msqlSelectDB() 

84 Funzione mqslQuery() 

85 Funzione msqlStoreResult() 


23 


11 


11 


12 
12 
12 
12 
1 


13 


10 
11 
12 
13 
14 
415 
„16 


17 


3. LI 


11. 


12. 


19. 


14. 


Funzione msqlFreeResult() 
Funzione msqlFetchRow() 
Funzione msqiDataSeek() 
Funzione msqlNumRows() 
Funzione msqlFetchField() 
Funzione msqlFieldSeek() 
Funzione msqlNumFields() 
Funzione msqlListDBs() 
Funzione msqlInitDB() 
Funzione msqlListTables() 
Funzione msqlListFields() 


Funzione msqlClose() 


BRERIA (API) DI PROGRAMMAZIONE IN JAVA 
Uso dell' API in Java 


Classe Msql 
Metodo Msql() 
Metodo Connect() 
Metodo SelectDB() 
Metodo ListFields() 
Metodo Query() 


Classe MsqlResult 
Membri della classe 
Metodo FetchRow() 
Metodo Close() 
Istruzioni fondamentali 
Package msql 

Esempio di programma in Java 


Esempi dell’autore di MsqlJava 
Esempio nostro 


ACCESSO DA LINGUAGGIO DI SCRIPT PERL 
PROGRAMMA CON INTERFACCIA HTML A MSQL 
IMPORTAZIONE DI DATI DA UN FILE DI TESTO 
ESEMPIO DI IMPORTAZIONE DI UN DATABASE 


DISPONIBILITA’ DEL SOFTWARE 


24 


13 
13 
13 
13 
13 
14 
14 
14 
14 
14 
15 


15 


18 


18 


19 


20 











4.1 


4.2 


4.3 


4.4 


Disponibilita” delPmSQL 


Disponibilita" dell'MsqlJava 


Installazione dell mSQL sull’IBM-RISC6000 


Mailing list 


25 


20 


20 


21 


22 


